<!DOCTYPE html>
<html lang="zh-cn">
<head>
  <meta charset="utf-8">
  <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
  <title>RESTfull 简介 - jouyouyun&#39;s blog</title>
  <meta name="renderer" content="webkit" />
<meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1"/>

<meta http-equiv="Cache-Control" content="no-transform" />
<meta http-equiv="Cache-Control" content="no-siteapp" />

<meta name="theme-color" content="#f8f5ec" />
<meta name="msapplication-navbutton-color" content="#f8f5ec">
<meta name="apple-mobile-web-app-capable" content="yes">
<meta name="apple-mobile-web-app-status-bar-style" content="#f8f5ec">


<meta name="author" content="jouyouyun" /><meta name="description" content="简介 RESTfull 即表现层状态转换，是一种设计风格，不是标准。其要点如下：
 资源由 URI 来指定
每个资源都有与之对应的 URI=，一个 =URI 只能对应一种资源，但一种资源可以对应多个 URI 不同的分类方法)。
 对资源的操作对应到 HTTP 协议提供的方法
如增删改查等操作，对应 HTTP 协议的 POST, DELETE, PUT, GET 等方法
 资源的表现形式通常广泛流行的协议和标准
如 JSON, XML, HTML 等格式，当然也可以是其它格式或者私有格式，但一定足够能描述自己
 通过操作资源的表现形式来操作资源
通过修改表现形式再辅以 HTTP 协议的方法，应用就可以管理资源
 以超媒体作为应用状态的引擎
资源相关操作的 URI 可附加在表现形式内，应用根据自身状态选择相应的 URI 来更改状态。
操作可以是 URI 外，也可以是一段代码，让应用执行。
 " /><meta name="keywords" content="jouyouyun, Hugo, theme, even" />






<meta name="generator" content="Hugo 0.54.0 with even 4.0.0" />


<link rel="canonical" href="https://jouyouyun.github.io/post/restfull-introduction/" />
<link rel="apple-touch-icon" sizes="180x180" href="/apple-touch-icon.png">
<link rel="icon" type="image/png" sizes="32x32" href="/favicon-32x32.png">
<link rel="icon" type="image/png" sizes="16x16" href="/favicon-16x16.png">
<link rel="manifest" href="/manifest.json">
<link rel="mask-icon" href="/safari-pinned-tab.svg" color="#5bbad5">


<link href="/dist/even.93844dae.min.css" rel="stylesheet">
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@fancyapps/fancybox@3.1.20/dist/jquery.fancybox.min.css" integrity="sha256-7TyXnr2YU040zfSP+rEcz29ggW4j56/ujTPwjMzyqFY=" crossorigin="anonymous">


<meta property="og:title" content="RESTfull 简介" />
<meta property="og:description" content="简介

RESTfull 即表现层状态转换，是一种设计风格，不是标准。其要点如下：


资源由 URI 来指定

每个资源都有与之对应的 URI=，一个 =URI 只能对应一种资源，但一种资源可以对应多个 URI 不同的分类方法)。

对资源的操作对应到 HTTP 协议提供的方法

如增删改查等操作，对应 HTTP 协议的 POST, DELETE, PUT, GET 等方法

资源的表现形式通常广泛流行的协议和标准

如 JSON, XML, HTML 等格式，当然也可以是其它格式或者私有格式，但一定足够能描述自己

通过操作资源的表现形式来操作资源

通过修改表现形式再辅以 HTTP 协议的方法，应用就可以管理资源

以超媒体作为应用状态的引擎

资源相关操作的 URI 可附加在表现形式内，应用根据自身状态选择相应的 URI 来更改状态。

操作可以是 URI 外，也可以是一段代码，让应用执行。
" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://jouyouyun.github.io/post/restfull-introduction/" />
<meta property="article:published_time" content="2018-05-10T21:38:21&#43;08:00"/>
<meta property="article:modified_time" content="2019-02-12T14:36:05&#43;08:00"/>

<meta itemprop="name" content="RESTfull 简介">
<meta itemprop="description" content="简介

RESTfull 即表现层状态转换，是一种设计风格，不是标准。其要点如下：


资源由 URI 来指定

每个资源都有与之对应的 URI=，一个 =URI 只能对应一种资源，但一种资源可以对应多个 URI 不同的分类方法)。

对资源的操作对应到 HTTP 协议提供的方法

如增删改查等操作，对应 HTTP 协议的 POST, DELETE, PUT, GET 等方法

资源的表现形式通常广泛流行的协议和标准

如 JSON, XML, HTML 等格式，当然也可以是其它格式或者私有格式，但一定足够能描述自己

通过操作资源的表现形式来操作资源

通过修改表现形式再辅以 HTTP 协议的方法，应用就可以管理资源

以超媒体作为应用状态的引擎

资源相关操作的 URI 可附加在表现形式内，应用根据自身状态选择相应的 URI 来更改状态。

操作可以是 URI 外，也可以是一段代码，让应用执行。
">


<meta itemprop="datePublished" content="2018-05-10T21:38:21&#43;08:00" />
<meta itemprop="dateModified" content="2019-02-12T14:36:05&#43;08:00" />
<meta itemprop="wordCount" content="766">



<meta itemprop="keywords" content="restfull," />
<meta name="twitter:card" content="summary"/>
<meta name="twitter:title" content="RESTfull 简介"/>
<meta name="twitter:description" content="简介

RESTfull 即表现层状态转换，是一种设计风格，不是标准。其要点如下：


资源由 URI 来指定

每个资源都有与之对应的 URI=，一个 =URI 只能对应一种资源，但一种资源可以对应多个 URI 不同的分类方法)。

对资源的操作对应到 HTTP 协议提供的方法

如增删改查等操作，对应 HTTP 协议的 POST, DELETE, PUT, GET 等方法

资源的表现形式通常广泛流行的协议和标准

如 JSON, XML, HTML 等格式，当然也可以是其它格式或者私有格式，但一定足够能描述自己

通过操作资源的表现形式来操作资源

通过修改表现形式再辅以 HTTP 协议的方法，应用就可以管理资源

以超媒体作为应用状态的引擎

资源相关操作的 URI 可附加在表现形式内，应用根据自身状态选择相应的 URI 来更改状态。

操作可以是 URI 外，也可以是一段代码，让应用执行。
"/>

<!--[if lte IE 9]>
  <script src="https://cdnjs.cloudflare.com/ajax/libs/classlist/1.1.20170427/classList.min.js"></script>
<![endif]-->

<!--[if lt IE 9]>
  <script src="https://cdn.jsdelivr.net/npm/html5shiv@3.7.3/dist/html5shiv.min.js"></script>
  <script src="https://cdn.jsdelivr.net/npm/respond.js@1.4.2/dest/respond.min.js"></script>
<![endif]-->

</head>
<body>
  <div id="mobile-navbar" class="mobile-navbar">
  <div class="mobile-header-logo">
    <a href="/" class="logo">jouyouyun</a>
  </div>
  <div class="mobile-navbar-icon">
    <span></span>
    <span></span>
    <span></span>
  </div>
</div>
<nav id="mobile-menu" class="mobile-menu slideout-menu">
  <ul class="mobile-menu-list">
    <a href="/post/">
        <li class="mobile-menu-item">Archives</li>
      </a><a href="/tags/">
        <li class="mobile-menu-item">Tags</li>
      </a><a href="/categories/">
        <li class="mobile-menu-item">Categories</li>
      </a>
  </ul>
</nav>
  <div class="container" id="mobile-panel">
    <header id="header" class="header">
        <div class="logo-wrapper">
  <a href="/" class="logo">jouyouyun</a>
</div>

<nav class="site-navbar">
  <ul id="menu" class="menu">
    <li class="menu-item">
        <a class="menu-item-link" href="/post/">Archives</a>
      </li><li class="menu-item">
        <a class="menu-item-link" href="/tags/">Tags</a>
      </li><li class="menu-item">
        <a class="menu-item-link" href="/categories/">Categories</a>
      </li>
  </ul>
</nav>
    </header>

    <main id="main" class="main">
      <div class="content-wrapper">
        <div id="content" class="content">
          <article class="post">
    
    <header class="post-header">
      <h1 class="post-title">RESTfull 简介</h1>

      <div class="post-meta">
        <span class="post-time"> 2018-05-10 </span>
        <div class="post-category">
            <a href="/categories/blog/"> BLOG </a>
            </div>
        
      </div>
    </header>

    <div class="post-toc" id="post-toc">
  <h2 class="post-toc-title">文章目录</h2>
  <div class="post-toc-content always-active">
    <nav id="TableOfContents">
<ul>
<li>
<ul>
<li><a href="#简介">简介</a></li>
<li><a href="#http-方法使用"><code>HTTP</code> 方法使用</a></li>
<li><a href="#示例">示例</a></li>
<li><a href="#参考文档">参考文档</a></li>
</ul></li>
</ul>
</nav>
  </div>
</div>
    <div class="post-content">
      <h2 id="简介">简介</h2>

<p><code>RESTfull</code> 即表现层状态转换，是一种设计风格，不是标准。其要点如下：</p>

<ul>
<li><p>资源由 <code>URI</code> 来指定</p>

<p>每个资源都有与之对应的 <code>URI=，一个 =URI</code> 只能对应一种资源，但一种资源可以对应多个 <code>URI</code> 不同的分类方法)。</p></li>

<li><p>对资源的操作对应到 <code>HTTP</code> 协议提供的方法</p>

<p>如增删改查等操作，对应 <code>HTTP</code> 协议的 <code>POST, DELETE, PUT, GET</code> 等方法</p></li>

<li><p>资源的表现形式通常广泛流行的协议和标准</p>

<p>如 <code>JSON, XML, HTML</code> 等格式，当然也可以是其它格式或者私有格式，但一定足够能描述自己</p></li>

<li><p>通过操作资源的表现形式来操作资源</p>

<p>通过修改表现形式再辅以 <code>HTTP</code> 协议的方法，应用就可以管理资源</p></li>

<li><p>以超媒体作为应用状态的引擎</p>

<p>资源相关操作的 <code>URI</code> 可附加在表现形式内，应用根据自身状态选择相应的 <code>URI</code> 来更改状态。</p>

<p>操作可以是 <code>URI</code> 外，也可以是一段代码，让应用执行。</p></li>
</ul>

<p>总结起来就是：通过改变资源的表现形式来更改资源状态，以表现形式里的超媒体信息来引导应用的状态改变。</p>

<p>现在很多设计只用到了 <strong>资源 <code>+</code> =HTTP=动词</strong> 的方式，但 <strong>超媒体</strong>  不容忽视，是与应用交互的核心。</p>

<h2 id="http-方法使用"><code>HTTP</code> 方法使用</h2>

<p>下面介绍几种常用的 <code>HTTP</code> 协议方法:</p>

<ul>
<li><p>POST</p>

<p>用于资源的添加</p></li>

<li><p>DELETE</p>

<p>用于资源的删除</p></li>

<li><p>PUT</p>

<p>用于修改资源，需要提供完整的资源信息，可用于修改资源多项字段</p></li>

<li><p>GET</p>

<p>用于资源的获取</p></li>

<li><p>PATCH</p>

<p>用于修改资源的单个字段</p></li>
</ul>

<h2 id="示例">示例</h2>

<p>如构建一个用户信息服务，=API= 按照 <code>RESTfull</code> 风格可设计如下：</p>

<ul>
<li><p><code>[POST] /users/:user</code> 添加用户</p></li>

<li><p><code>[DELETE] /users/:user</code> 删除用户</p></li>

<li><p><code>[PUT] /users/:user</code> 修改用户整体信息</p></li>

<li><p><code>[PATCH] /users/:user</code> 修改用户的单个字段</p></li>

<li><p><code>[GET] /users/:user</code> 获取用户信息</p></li>

<li><p><code>[GET] /users</code> 获取所有用户信息</p></li>
</ul>

<p>另外在 <code>GET</code> 的信息中加入 <code>DELETE, PUT, PATCH</code> 的 <code>URI=，应用就可以根据这些 =URI</code> 显示可以进行的操作，动态的生成页面。
此种方法也减少了耦合，避免了 <code>URI</code> 变更时大量的修改。</p>

<hr />

<p>尽管上面的描述很简单，但也能发现采用 <code>RESTfull</code> 来设计 <code>Web API</code> 是一种简洁明了的方案，通过与 <code>HTTP</code> 动词结合，避免了在 <code>URI</code> 中设置大量动词的问题，需要关注的只是对资源的抽象和划分。</p>

<p>本文到此为止，关于 <code>RESTfull</code> 更多更详尽的内容请自行查找。</p>

<h2 id="参考文档">参考文档</h2>

<ul>
<li><a href="http://www.infoq.com/cn/articles/rest-introduction">深入浅出REST</a></li>
<li><a href="http://www.ruanyifeng.com/blog/2011/09/restful.html">理解RESTful架构</a></li>
<li><a href="http://www.ruanyifeng.com/blog/2014/05/restful%5Fapi.html">RESTful API 设计指南</a></li>
<li><a href="http://novoland.github.io/%E8%AE%BE%E8%AE%A1/2015/08/17/Restful%20API%20%E7%9A%84%E8%AE%BE%E8%AE%A1%E8%A7%84%E8%8C%83.html">Restful API 的设计规范</a></li>
</ul>
    </div>

    <div class="post-copyright">
  <p class="copyright-item">
    <span class="item-title">文章作者</span>
    <span class="item-content">jouyouyun</span>
  </p>
  <p class="copyright-item">
    <span class="item-title">上次更新</span>
    <span class="item-content">2019-02-12</span>
  </p>
  
  
</div><div class="post-reward">
  <input type="checkbox" name="reward" id="reward" hidden />
  <label class="reward-button" for="reward">赞赏支持</label>
  <div class="qr-code">
    
    <label class="qr-code-image" for="reward">
        <img class="image" src="/images/reward/wechat-qr-code.png">
        <span>微信打赏</span>
      </label>
    <label class="qr-code-image" for="reward">
        <img class="image" src="/images/reward/alipay-qr-code.png">
        <span>支付宝打赏</span>
      </label>
  </div>
</div><footer class="post-footer">
      <div class="post-tags">
          <a href="/tags/restfull/">restfull</a>
          </div>
      <nav class="post-nav">
        <a class="prev" href="/post/fixed-superblock/">
            <i class="iconfont icon-left"></i>
            <span class="prev-text nav-default">修复 superblock</span>
            <span class="prev-text nav-mobile">上一篇</span>
          </a>
        <a class="next" href="/post/git-rebase/">
            <span class="next-text nav-default">Git Rebase 回退</span>
            <span class="next-text nav-mobile">下一篇</span>
            <i class="iconfont icon-right"></i>
          </a>
      </nav>
    </footer>
  </article>
        </div>
        

      </div>
    </main>

    <footer id="footer" class="footer">
      <div class="social-links">
      <a href="mailto:jouyouwen717@gmail.com" class="iconfont icon-email" title="email"></a>
      <a href="https://twitter.com/jouyouyun" class="iconfont icon-twitter" title="twitter"></a>
      <a href="https://github.com/jouyouyun" class="iconfont icon-github" title="github"></a>
  <a href="https://jouyouyun.github.io/index.xml" type="application/rss+xml" class="iconfont icon-rss" title="rss"></a>
</div>

<div class="copyright">
  <span class="power-by">
    由 <a class="hexo-link" href="https://gohugo.io">Hugo</a> 强力驱动
  </span>
  <span class="division">|</span>
  <span class="theme-info">
    主题 - 
    <a class="theme-link" href="https://github.com/olOwOlo/hugo-theme-even">Even</a>
  </span>

  

  <span class="copyright-year">
    &copy; 
    2014 - 
    2019
    <span class="heart">
      <i class="iconfont icon-heart"></i>
    </span>
    <span class="author">jouyouyun</span>
  </span>
</div>
    </footer>

    <div class="back-to-top" id="back-to-top">
      <i class="iconfont icon-up"></i>
    </div>
  </div>
  
  <script src="https://cdn.jsdelivr.net/npm/jquery@3.2.1/dist/jquery.min.js" integrity="sha256-hwg4gsxgFZhOsEEamdOYGBf13FyQuiTwlAQgxVSNgt4=" crossorigin="anonymous"></script>
  <script src="https://cdn.jsdelivr.net/npm/slideout@1.0.1/dist/slideout.min.js" integrity="sha256-t+zJ/g8/KXIJMjSVQdnibt4dlaDxc9zXr/9oNPeWqdg=" crossorigin="anonymous"></script>
  <script src="https://cdn.jsdelivr.net/npm/@fancyapps/fancybox@3.1.20/dist/jquery.fancybox.min.js" integrity="sha256-XVLffZaxoWfGUEbdzuLi7pwaUJv1cecsQJQqGLe7axY=" crossorigin="anonymous"></script>
<script type="text/javascript" src="/dist/even.ece58db6.min.js"></script>








</body>
</html>
